Skip to main content
GET
Handles `GET /v1/control/verification-sessions/{session_id}`.

Authorizations

esectra_session
string
cookie
required

A signed-in reviewer's session. httpOnly and SameSite=Lax; set by POST /v1/control/sessions and only usable once the second factor is met.

Path Parameters

session_id
string
required

The session id

Response

The session, its checks and its resolved decision

One session in full.

created_at
string
required

When the session was opened.

expires_at
string
required

When the capture link stops working.

intent
string
required

FIRST_TIME or REVERIFICATION.

session_id
string
required

The session id, which the capture link and the webhook both carry.

status
string
required

PENDING, PASSED, REVIEW_REQUIRED, FAILED or EXPIRED.

subject_id
string
required

The person, as the customer identifies them.

checks
object[]
required

Every required check in policy order, then any that ran unrequired.

policy_version
string
required

The policy version whose checks this session had to satisfy.

reasons
object[]
required

Why the decision was what it was, from the decision store, reworded.

completed_at
string | null

When the session concluded. Absent while it is open.

decision
null | enum<string>

That decision's outcome, read from the decision store.

Available options:
ALLOW,
WARN,
BLOCK,
HOLD,
REVIEW_REQUIRED,
FLAG,
BLOCK_RECOMMENDED,
SUSPEND,
END_STREAM
decision_id
string | null

The decision the session produced, once it has.

review_case_id
string | null

The review case opened for the decision, read from the case store.

risk_level
null | enum<string>

That decision's risk level, read from the decision store.

Available options:
LOW,
MEDIUM,
HIGH,
CRITICAL